home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 2 / MacMania 2.toast / Demo's / Tools&Utilities / Programming / FBSpriteWorld 1.05b / FBSpriteWorld Read Me
Encoding:
Text File  |  1994-04-24  |  6.4 KB  |  77 lines  |  [TEXT/ttxt]

  1. ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  2.                                        FBSPRITEWORLD version 1.01B
  3.  
  4. Copyright 1994 by Robert W. Hommel
  5. Based on "SpriteWorld" by Tony Myles
  6. ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  7.  
  8. This is the first beta release of the FutureBasic version of SpriteWorld.
  9.  
  10. Many apologies for the delay in getting out this version of FBSpriteWorld.  Many things have happened in my life since I first promised to upload my fledgling attempts at
  11. creating sprite-based animation on the Macintosh in FutureBasic.  I have a new full-time job, which often requires long hours; my wife and I are expecting our first child in October 1994; the L.A. earthquake, which so damaged the house we were buying that the bank refused to fund our loan and catapulted us back into "house-hunting"; and, finally, another freeware package I uploaded, "SndTutor", brought a contract programming job my way.
  12.  
  13. I will *TRY* to be deligent about improving and upgrading FBSpriteWorld, but I invite you to participate in its development as well.  I would only ask that you coordinate any major enhancement with me, so that we don't have a slug of competing versions floating around (if you have a couple new routines, feel free to to post them separately from this package; if you send them to me, I will include them in any upgrade I publish).  
  14.  
  15. Feel free to distribute FBSpriteWorld anywhere you like, provided you distribute the entire package, including this file.
  16.  
  17. WHAT IS FBSPRITEWORLD?
  18.  
  19. "SpriteWorld" was originally published and generously placed in the public domain by Tony Myles.  It is a *MAJOR* work, written in THINK C, containing full source code, code libraries, documentation, and examples.  I highly recommend it to you, regardless of which programming language you use.
  20.  
  21. My original intent was to 'translate' SpriteWorld, line by line, into FutureBasic.  I quickly rejected this approach, both from my lack of programming expertise and from the daunting (and frankly boring) task of translating several thousand lines of code with little or no creative challenge.  Instead, I 'reverse engineered' Tony's version, using SpriteWorld as a sort of "animation reference manual."  I took the basic concepts of Sprites, Frames, Layers and SpriteWorlds themselves, and tried to implement them in FutureBasic.
  22.  
  23. The result is a Sprite-based animation architecture which allows you to add smooth, multi-layered animation to your FutureBasic programs.  It supports Black and White and Color Quickdraw, and (provided the user has System 7 and the Extended Time Manager), should run on any Macintosh at any screen depth.  This version is somewhat optimized, in that it rigorously checks to be sure which Sprites need to be drawn, however there is room for improvement here.  If you want to include relatively simple animation in your application, or write an animated About box, this version of FBSpriteWorld will suffice nicely.  If, however, you want to write the next Crystal Quest, you'll need to add some optimizations (and if you do, please share them)!
  24.  
  25. Since this is not truly a Future Basic clone of SpriteWorld, I ask that you not hold Tony Myles responsible for any lack in performance, bugs, or 'undocumented features.'  While Tony has given his permission and support for FBSpriteWorld, any flaws and deficiencies are mine and mine alone.
  26.  
  27. WHAT THE FBSPRITEWORLD INCLUDES
  28.  
  29. FBSpriteWorld includes the following:
  30.  
  31. 1)    Project folder
  32.         FBSpriteWorld.incl                    -          FBSpriteWorld include file 
  33.         FBSpriteWorld.glbl              -          FBSpriteWorld globals file
  34.           FBSpriteWorld.rsrc             -           FBSpriteWorld resource file
  35.         GraphicUtils.incl                 -          General graphics utilities include file
  36.         GraphicUtils.glbl                 -          Graphics utilities globals file
  37.         TimeManager.incl                -          Time Manager utilities include file
  38.                 SWStandardProcs.txt                    -                  Standard Procedures text file
  39. 2)  Documentation folder
  40.         Inside FBSpriteWorld.doc     -         MS Word version of documentation
  41.         Inside FBSpriteWorld.wrt     -         MacWrite II version of documentation
  42. 3)  Examples folder
  43.         SWSimpleTest.main              -         Simple Animation demo w/1 sprite
  44.         SWSpinningGlobe.main          -         More complex Animation demo
  45.         SWSimpleBreakOut.main       -         Incomplete Break Out game demo
  46.  
  47. To run the demos, drag one of the main files into the Project folder.  Compile with
  48. the following default settings:
  49.  
  50.         - Space required after keywords
  51.         - Optimize expressions as integer
  52.                 - Arrays WITH element 0
  53.  
  54. LEGALITIES
  55.  
  56. The FBSpriteWorld source code is wholly owned and Copyright 1994 by Robert Hommel. Permission  is hereby granted for anyone to create applications or other programs using the FBSpriteWorld code free of charge, royalty, or restrictions of any kind pertaining to the distribution, sale of, or licensing of such derivative works. You may not charge any fee for FBSpriteWorld itself other than the ordinary online, or distribution charges normally incurred for the distribution medium. 
  57.  
  58. The only thing I ask in exchange for FBSpriteWorld, is a free copy for both Tony Myles and myself (that is make us fully paid, registered users) of any cool game that you write with FBSpriteWorld. 
  59.  
  60. Tony Myles                                                                            Robert Hommel
  61. America Online: Suiryu                                        America Online: RWHommel
  62. Compu$erve: 72070,3000                                Compuserve: 71061,3327
  63. Internet: suiryu@aol.com                                Internet: hommelr@avery.ccmail.com
  64.  
  65. I would further ask that if you use my routines verbatim in your program, you credit me in your program and/or documentation.
  66.  
  67. ABOUT THE AUTHOR
  68.  
  69. I have over 10 years programming experience on Macs and PC's in various languages.  I have written nearly a dozen commercial applications, many of them in FB.  I am available for contract programming, time and energy permitting.  If you have a really fun project, I'll make the time and find the energy!
  70.  
  71. FINAL THOUGHTS
  72.  
  73. Please notify me at one of the above mail addresses if you find any bugs or problems with FBSpriteWorld.  I will do my best to post timely updates.  
  74.  
  75. When asking for help or support, please keep in mind that I have a full-time job, a family, and other programming interests.  I usually check AOL and Compuserve at least once a week, but I have regularly gone several weeks or more without accessing either.  
  76. Please be patient!
  77.